(error): Doc fix.

diff --git a/lisp/subr.el b/lisp/subr.el
index f73a29ad11bda24f3ac0d9c3d15a09c4b480cebd..f96351e6e4d68c9c859fcd1ed0016ea12b0e2260 100644 (file)
--- a/lisp/subr.el
+++ b/lisp/subr.el
@@ -704,7 +704,10 @@ This function accepts any number of arguments, but ignores them."
   nil)
 
 (defun error (&rest args)
-  "Signal an error, making error message by passing all args to `format'."
+  "Signal an error, making error message by passing all args to `format'.
+In Emacs, the convention is that error messages start with a capital
+letter but *do not* end with a period.  Please follow this convention
+for the sake of consistency."
   (while t
     (signal 'error (list (apply 'format args)))))